home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / dailydump / RCS / dailydump.man,v < prev   
Encoding:
Text File  |  1991-09-28  |  5.0 KB  |  206 lines
  1. head     1.5;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.5
  10. date     91.09.28.15.57.30;  author kupfer;  state Exp;
  11. branches ;
  12. next     1.4;
  13.  
  14. 1.4
  15. date     91.09.28.15.54.39;  author shirriff;  state Exp;
  16. branches ;
  17. next     1.3;
  18.  
  19. 1.3
  20. date     91.08.29.18.42.54;  author kupfer;  state Exp;
  21. branches ;
  22. next     1.2;
  23.  
  24. 1.2
  25. date     91.08.29.18.28.29;  author kupfer;  state Exp;
  26. branches ;
  27. next     1.1;
  28.  
  29. 1.1
  30. date     90.12.17.18.19.17;  author kupfer;  state Exp;
  31. branches ;
  32. next     ;
  33.  
  34.  
  35. desc
  36. @Man page for script to do daily dumps.
  37. @
  38.  
  39.  
  40. 1.5
  41. log
  42. @Store the name of the host running the dumps in the .active file.
  43. @
  44. text
  45. @'\" Copyright 1990 Regents of the University of California
  46. '\" Permission to use, copy, modify, and distribute this
  47. '\" documentation for any purpose and without fee is hereby
  48. '\" granted, provided that this notice appears in all copies.
  49. '\" The University of California makes no representations about
  50. '\" the suitability of this material for any purpose.  It is
  51. '\" provided "as is" without express or implied warranty.
  52. '\" 
  53. '\" $Header: /sprite/src/admin/dailydump/RCS/dailydump.man,v 1.4 91/09/28 15:54:39 shirriff Exp Locker: kupfer $ SPRITE (Berkeley)
  54. '/" 
  55. .so \*(]ltmac.sprite
  56. .HS DAILYDUMP cmds
  57. .BS
  58. '\" Note:  do not modify the .SH NAME line immediately below!
  59. .SH NAME
  60. dailydump \- Script to do daily dumps
  61. .SH SYNOPSIS
  62. \fBdailydump\fR [\fB\-i\fR] [\fIstartFs\fR]
  63. .IP "\fIstartFs\fR" 15
  64. Start dumping with the named filesystem.
  65. .IP "\-i" 15
  66. Initialize the tape drive, remove the weekly dump lock file, and exit.
  67. .BE
  68.  
  69. .SH DESCRIPTION
  70. .PP
  71. This script does a level-1 dump of all filesystems that are normally
  72. backed up.  (A level-1 dump captures all changes since the previous
  73. level-0 dump for the given filesystem.)  It is normally invoked in the
  74. wee hours of the morning by
  75. .BR cron .
  76. .PP
  77. When the script has completed, it sends mail to the current dumper
  78. (see the man page for
  79. .BR weeklydump ), 
  80. giving the amount of free space left on the current tape.
  81. If there are detectable errors, mail is sent to the dumper with an error
  82. message.
  83. .PP
  84. There are normally two reasons for manually invoking
  85. .BR dailydump .
  86. The first is to re-enable the daily dumps after the weekly dumps have
  87. completed.  This is what the
  88. .B \-i
  89. option is for.  It ensures that the lock file used by the weekly dumps
  90. is gone, and it initializes the tape currently in the drive.  (The dumps won't
  91. actually commence until invoked by
  92. .BR cron ).
  93. .PP
  94. The other reason for invoking 
  95. .B dailydump
  96. by hand is to restart the dumps if the machine running them crashed
  97. before the dumps could finish.  In this case the user should specify the
  98. filesystem that was being dumped when the machine crashed.  The dumps
  99. will begin immediately.
  100. .PP
  101. When invoking 
  102. .BR dailydump , 
  103. be sure you're running as root.
  104.  
  105. .SH FILES
  106. All of the following files are in /sprite/admin/dump:
  107. .IP doingdaily.active 15
  108. status file used to detect crashes.  Contains the name of the host
  109. running the dumps.
  110. .IP doingweekly 15
  111. lock file to prevent daily dump from running
  112. .IP dumpdates 15
  113. list of filesystems dumped, at what time, what tape, etc.
  114. .IP dumplist 15
  115. list of filesystems to dump
  116. .IP dumplog 15
  117. very large status log from the dump programs
  118. .IP tapelist 15
  119. list of tape devices to use.  Dailydump uses the first drive on the list.
  120.  
  121. .SH KEYWORDS
  122. dump, tape, backup
  123. @
  124.  
  125.  
  126. 1.4
  127. log
  128. @Documented tapelist file.
  129. @
  130. text
  131. @d9 1
  132. a9 1
  133. '\" $Header: /sprite/src/admin/dailydump/RCS/dailydump.man,v 1.3 91/08/29 18:42:54 kupfer Exp Locker: shirriff $ SPRITE (Berkeley)
  134. d64 2
  135. a65 1
  136. status file used to detect crashes
  137. @
  138.  
  139.  
  140. 1.3
  141. log
  142. @Fix the way the files are listed so that they look better when nroff'd.
  143. @
  144. text
  145. @d9 1
  146. a9 1
  147. '\" $Header: /sprite/src/admin/dailydump/RCS/dailydump.man,v 1.2 91/08/29 18:28:29 kupfer Exp Locker: kupfer $ SPRITE (Berkeley)
  148. d46 1
  149. a46 1
  150. is gone, and it initializes the tape currently in the drive.  (The dumps don't
  151. d73 2
  152. @
  153.  
  154.  
  155. 1.2
  156. log
  157. @Add info about command line options.  Fix description about error
  158. handling.  Add list of magic dump-related files.
  159. @
  160. text
  161. @d9 1
  162. a9 1
  163. '\" $Header: /sprite/src/admin/dailydump/RCS/dailydump.man,v 1.1 90/12/17 18:19:17 kupfer Exp Locker: kupfer $ SPRITE (Berkeley)
  164. d63 10
  165. a72 11
  166. .ta \w'doingdaily.active....'u
  167. .PP
  168. doingdaily.active    status file used to detect crashes
  169. .br
  170. doingweekly    lock file to prevent daily dump from running
  171. .br
  172. dumpdates    list of filesystems dumped, at what time, what tape, etc.
  173. .br
  174. dumplist    list of filesystems to dump
  175. .br
  176. dumplog    very large status log from the dump programs
  177. @
  178.  
  179.  
  180. 1.1
  181. log
  182. @Initial revision
  183. @
  184. text
  185. @d9 1
  186. a9 1
  187. '\" $Header: /sprite/lib/forms/RCS/cmd.man,v 1.2 90/02/20 17:11:01 douglis Exp $ SPRITE (Berkeley)
  188. d18 5
  189. a22 1
  190. \fBdailydump\fR 
  191. d33 6
  192. a38 6
  193. This script does no error checking.  After it has run, you should
  194. check
  195. .B /sprite/admin/dump/dumplog
  196. and perhaps
  197. .B /sprite/admin/dump/dumpdates
  198. to make sure everything worked correctly.
  199. d40 34
  200. a73 4
  201. The script appends each night's dumps to the end of the currently
  202. loaded dump tape.  Run
  203. .B dumpsize
  204. to see if there is enough room on the tape for another set of dumps.
  205. @
  206.